home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 480.lha / SmartField / Docs / Getting Started.pp / Getting Started
Encoding:
Text File  |  1991-02-11  |  5.6 KB  |  131 lines
  1. GETTING STARTED
  2.  
  3.  
  4. This section takes you through the steps necessary to build the console.lib
  5. library of compiled SmartFields functions.  Even if you are an experienced C
  6. programmer, we suggest that you read through these steps.
  7.  
  8.  
  9. 1.  Take a minute to fill out the registration card and mail it
  10.     back to us right away.
  11.  
  12.         "Well, obviously this no longer applies since this is no longer a
  13.         commercial product."  --Timm.
  14.  
  15.  
  16. 2.  Make a backup copy of your SmartFields diskette.
  17.  
  18.         The SmartFields diskette is not copy-protected in any way.  Make sure
  19.         your original SmartFields diskette is write-protected, duplicate it,
  20.         then put it away for safekeeping.  Our policy is to provide
  21.         extensive, detailed documentation in the hope that it will convince
  22.         people to purchase the package in order to also get the manual.  We
  23.         feel that punishing our respected customers with copy-protection
  24.         because of a few bad pirates is not a fair practice.  Please
  25.         discourage software piracy.  It hurts software developers in the form
  26.         of lower revenues and it hurts good customers like you in the form of
  27.         higher prices.  Spread the word, not the disk.
  28.  
  29.  
  30. 3.  Modify the console include files.
  31.  
  32.         The include files to be copied to your work disk are
  33.         located in the include directory on your SmartFields
  34.         diskette.  This directory contains two subdirectories named
  35.         console and toolkit.
  36.  
  37.         a.  Load the console.h include file from the console subdirectory
  38.             into your program editor.
  39.  
  40.             1.  Near the end of a file, you will find the TAB_JUMP
  41.                 definition set to 4.  This is the number of character
  42.                 positions that the cursor will jump when the user presses the
  43.                 TAB button.  If you wish, change this value.
  44.  
  45.             2.  Just below that, you will find the DEFAULT_TYPE_MODE
  46.                 definition set to TYPEOVER_TYPE_MODE.  Change this value if
  47.                 you wish insert mode to be the default type mode.
  48.  
  49.             3.  When you are finished, save this file back to the diskette.
  50.  
  51.         b.  Load the fields.h include file from the console subdirectory into
  52.             your program editor.  At the end of the file you will notice a
  53.             block of definition which redefines the strcpy() and strlen()
  54.             functions with the _BUILTIN_ prefix.  If your compiler does not
  55.             support this feature, remove this block.  When you are finished,
  56.             save this file back to the diskette.
  57.  
  58. 4.  Create the console include files.
  59.  
  60.         a.  Locate your include directory on your work disk.  This is the
  61.             directory which contains all of the include files needed to
  62.             compile your Amiga C programs, including the Amiga include file
  63.             sub-directories such as exec, graphics, intuition, and workbench.
  64.             Here, create a sub-directory named console and a sub-directory
  65.             named toolkit.
  66.  
  67.         b.  Copy the three files contained in the console subdirectory of the
  68.             include directory on your SmartFields diskette into your newly
  69.             created console directory.
  70.  
  71.         c.  Copy the toolkit.h include file contained in the toolkit
  72.             subdirectory of the include directory on your SmartFields
  73.             diskette into your newly created toolkit directory.  NOTE:  If
  74.             you already have a toolkit/toolkit.h include file from the C
  75.             Toolkit (also by Software Ingenuity), do NOT replace this with
  76.             toolkit.h file supplied with SmartFields!  It will already
  77.             contain all of the necessary definitions.
  78.  
  79. 5.  Check the intuition/intuition.h include file.
  80.  
  81.         For SmartFields to work properly, you must have a recent version of the
  82.         intuition/intuition.h include file.  Load the file into your text editor
  83.         and examine the Window structure.  The last three parameters of the
  84.         structure should read:
  85.  
  86.             struct Window {
  87.                 ...
  88.                 BYTE *UserData;
  89.                 struct Layer *WLayer;
  90.                 struct TextFont *IFont;
  91.             };
  92.  
  93.         If your version of the file does not have that last parameter
  94.         (IFont), add it, then save the file.
  95.  
  96. 6.  Compile the SmartFields functions.
  97.  
  98.         The console.compile batch file located in the functions directory on
  99.         your SmartFields diskette was provided for you to mass-compile all of
  100.         the functions at once.  Load this file into your program editor and
  101.         mass replace the cc command with the name of your compiler and any
  102.         required flags.  Then execute this batch file.  This will create the
  103.         .o files for all of the SmartFields functions.
  104.  
  105. 7.  Create the console.lib library.
  106.  
  107.         The create.lib batch file also located in the functions directory on
  108.         your SmartFields diskette was provided for you to create the
  109.         console.lib library.  Load this file into your program editor and
  110.         change any necessary commands to conform to your librarian.  Note
  111.         that the console.lib.build file provided in the same directory
  112.         contains a list of all of the .o SmartFields functions required for
  113.         console.lib.
  114.  
  115. 8.  Copy the console.lib to your library directory.
  116.  
  117.         Locate the directory on your work disk containing all of the
  118.         libraries with which you link your C programs including the standard
  119.         C library.  Copy your newly created console.lib to this directory.
  120.  
  121. 9.  Congratulations!
  122.  
  123.         You are now ready to write your own SmartFields programs!
  124.  
  125.  
  126. Getting Started  01/13/90
  127. © Copyright 1990 Timm Martin
  128. All Rights Reserved Worldwide
  129.  
  130. /*-- END --*/
  131.